home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Resources / System / VersCheck2 / Doku / NewInThisVersion < prev    next >
Text File  |  1999-12-30  |  12KB  |  272 lines
  1. New in this Version: (V 2.19.2 / 20.12.1999)
  2. ============================================
  3. (at the end you find info's about printout's and special's ( *-> ) 
  4.  
  5. V 2.19.1: Fixed a bug in the installer script
  6. V 2.19.2: Updated français catalog included
  7.           New russian catalog and Check_Your_System included
  8.           Change in install script for russian and setting user
  9.           mode to expert before copy the library's to skip this
  10.           part, if needed.
  11.  
  12.  
  13. New version identification:
  14. ---------------------------
  15. The search for version numbers work's now nearly perfect. Based on a
  16. new idea I rewrite the search and analyse of the $VER-string.
  17. This new function is faster and find such versions, they are not found
  18. before. Only in one reason, the search failed: If the version is not
  19. numeric or has a VERSION.REVISION as MINIMUM! More ok, shorter: NO!
  20. I know only TWO file where this is so. In one is the version 1.L (what
  21. causes much problems in c:version!). The second is a library with
  22. the version V1. Great! Check it with c:version and this program don't
  23. know, what cat it do. So it do VERSION name FULL or simple: It cry's
  24. for help!
  25. What do, if such libs found?
  26. MOVE to STORAGE to check out with program such library use. Often, the
  27. program dosn't exist anymore or is updated and don't use this lib in the
  28. actual version. If you can be 100% shure that don't need this library,
  29. delete and bann them from your system. If you find put that the library
  30. is in use, inform the author of the library, to correct the resident tag
  31. and the $VER: to a correct format. Inform also the author of the application
  32. that use this library that he needs a library what isn't systemconform, and,
  33. e.g. do not correct work in systems with WB2.0. In future it is possible that
  34. new systems for Amiga and cloned systems also make problems with such
  35. header's.
  36. I ignore such single problems now for a faster and better function.
  37.  
  38.  
  39.  
  40. Statistic requester:
  41. --------------------
  42. Based of an idea, reached per eMail, from Michael Malyshev
  43. <michael_malyshev@mail.ru>, the compare has now a little statistic.
  44. The special is, at the end of a scan you see a comment, added by
  45. VersCheck. I hope, you have enough black humor for that.With -# can
  46. be used do deactivate the function. Default is set by environment or ON!
  47. More info's about this function? Check it out!
  48. P.S.: The requester is at the moment only in german or english!
  49.  
  50.  
  51.  
  52. Locale (.catalog's):
  53. --------------------
  54. Because the new function uses new catalog's, I've checkt all old function
  55. part's and put also older, forgotten text to the locale.
  56.  
  57.  
  58.  
  59. Environment:
  60. ------------
  61. Looking in ENV:VCheck you will find many little files. This are:
  62.  
  63. - VersIM1, VersIM2, VersIM3, VersIM4, VersDoc and VersDir:
  64.   This is the installer setup from last install as default at next update.
  65.  
  66. - VersCom
  67.   (default inside: VERSION). Needs to change name or path for external
  68.   version command. PLEASE DON'T USE VERSIONWB because this will force
  69.   problems in the CheckGuides!
  70.  
  71. - VersCOL
  72.   includes 16(+) line. Any line is the Ansi-setup for a output line from
  73.   verscheck. Discription below.
  74.  
  75. - The new default setup for the requester in VersCheck V2.19 (default is
  76.   NOT(!) compatible to older version):
  77.  
  78.   - VersIFS = info requester
  79.               0 = OFF
  80.               1 = ON  is the default
  81.               Argument '-!' toggle
  82.   - VersSTR = NO statistic requester
  83.               1 = no request
  84.               0 = show this requester is the default
  85.               Argument '-#' toggle
  86.   - VersNRQ = NO requester
  87.               1 = no requester
  88.               0 = requester allowed is the default
  89.               Argument '-n' toggle
  90.   - VersHTM = html request return value
  91.               0 = no output
  92.               1 = create update forms is the default
  93.               Argument '-o' toggle
  94.   You can use this to change the default but the switches work's
  95.   than reverse! Be carefull. This is, what I mean with toggle:
  96.   If ENV: set to ON the argument set it to OFF.
  97.   If ENV: set to OFF the argument set it to ON.
  98.   And if the argument used more times, it goes ON/OFF.
  99.   The Argument DON'T change the ENV:
  100.  
  101.  
  102.  
  103. ANSI output (de-)activate and usage:
  104. ------------------------------------
  105. Long time ago, I begin the work an a little styling function. The
  106. functions are now useable and I have finished the work. No big help
  107. or doc (see AmigaDOS documentation for ansi, line discription here).
  108. All lines can now displayed negativ, highlighted, colored, big or in many other ways. Used is
  109. ANSI. Ansi exists in the DOS-CLI/-Shell. At this time you can only
  110. set the values at the begin of line, all other is hardcoded in
  111. VersCheck.
  112.  
  113. *** YOU MUST KNOW, HOW ANSI WORK! *** For insiders: **************
  114. CSI and m are fixed, value inserted from simple config file
  115. 'Env:VCheck/VersCOL'. You can set all value's that allowed between
  116. esc[ and m. Also from 0 upto 9 (attributes), 30 upto 37 foreground
  117. and 40 upto 47 for the background. Combination like 0;3;45 are
  118. accepted.
  119. ******************************************************************
  120.  
  121. You find a demo in configuration in the archive of this version.
  122. Deactivate: Simply remove the config file from ENV: and/or ENVARC:
  123. About the config: Useable with 4 color's and regulary WB color
  124. setting for the first four colors. If you are using a CLI with 8 or
  125. more colors you can use more colors.
  126. WARNING! This function takes, whatever in the file set. No check or
  127. such things. If you write bad strings, the function takes it and
  128. ansi will display it, but this forces broken or unreadable output.
  129. Second problem: If you set foreground and background to same values
  130. you will see nothing!
  131.  
  132. == LINES IN THE FILE: ==============================================
  133. ====================================================================
  134. Line  | descryption (without warranty):
  135. ------+-------------------------------------------------------------
  136.   1   | all line without setting, like ths --- line between the files
  137.   2   | version new: "file unknown in list"
  138.   3   | version ok
  139.   4   | version new (but in the list!)
  140.   5   | version old
  141.   6   | version line "problem with version"
  142.       |              (what to do: kill the file or the author or send
  143.       |               him a copy of the Rom Kernal Manual to read them)
  144.   7   | fileinformation and filename
  145.   8   | version line "VersCheck"
  146.   9   | version line "c:version"
  147.  10   | version line "list"
  148.  11   | system information (kickstart/workbench)
  149.  12   | output of a warn/xxx file
  150.  13   | help text if using -?
  151.  14   | error messages at program start
  152.  15   | LISTMODE: directory header
  153.  16   | filename in verbose, path see 19 (-v) 
  154.  17   | cli output of requester "you find the results in ram"
  155.  18   | system information (cpu/fpu/mmu/ppc)
  156.  19   | fullpath (-f) without filename! The name is print later
  157.       | and set with line 16 (because this function print add name!
  158.  
  159.  
  160.  
  161. Requester now ASL:
  162. ------------------
  163. The problem with the requesters from the older versions are fixed
  164. and the asl requester activated. ReqTools is not longer needed or
  165. used!
  166. WARNING for GERMAN! UPDATE the locale catalog files or you will see
  167. all new text in english!
  168.  
  169.  
  170.  
  171. Goodies:
  172. --------
  173. Check_Your_System changed to work correct with the ENV: settings.
  174.  
  175.  
  176.  
  177. Install script:
  178. ---------------
  179. After install V2.19 the system should be reboot or a program like
  180. FLUSHLIBS must be used to clear the old catalog files from memory.
  181. Of cource, if you have not started VersCheck before you make the
  182. new installation, this isn't need!
  183.  
  184. The script was changed for multiple things:
  185. - In the past ENV: was not updated, only envarc: so that after an
  186.   update the system has to reboot for correct environment. Now both
  187.   area's are updated.
  188.  
  189. - Add new information at the begin and the end of the installer script,
  190.   e.g., version and date.
  191.  
  192. - Change and add installing of the documents, because they are renamed
  193.   and new files added.
  194.  
  195.  
  196.  
  197. Bugfix: (memory fault):
  198. -----------------------
  199. Bugfix: Since using the new ppc-library-emulation the library check causes
  200. an error: 0 bytes allocated and after them max int bytes allocated.
  201. Then VersCheck crashes. I detect the library who forces this crash and
  202. locked in the binary for $VER:, to see what happens here.
  203. The problem: "$VER:<NULL>" gives a empty env-variable and this, read with
  204. getenv from vbcc crashes! Fixed. Now the function looking before read how
  205. many bytes the env count's. Read now only, if a minimum of 3 bytes are
  206. in the env.var!
  207. The new ppc.emu [ppc.library 46.21 (12.12.99) Emulation v0.7 by
  208. Frank Wille <frank@phoenix.owl.de>] found an other problem. If checking
  209. an elf.-file it isn't need to test the resident tag of m68k. But, even
  210. this was done in the past. Normally the function returns with a NOT FOUND
  211. and end's. But now a svppc driver exists who has the code for the resident
  212. tag without such a tag (in m68k is this forbidden, but this is a elf-PPC
  213. executable with totally other code). Result: MEMORY FAULT. Problem found
  214. and fixed.
  215.  
  216.  
  217.  
  218. Bad code cleared:
  219. -----------------
  220. The variable ENV:VCheck/VersCOM has read any time before the version was
  221. checked with the external program (c:version). This isn't need and now
  222. the variable is read at program start. This make the program faster and
  223. that is the better way to do it.
  224. I can't remember, why I programmed this so in the past. I think, I've
  225. only not realised that this is an multiple read.
  226.  
  227.  
  228. ^^^^^^^^^^^^^^^^^^^^^
  229. ^^^^ END OF NEWS ^^^^
  230. ^^^^             ^^^^
  231. ^^^^^^^^^^^^^^^^^^^^^
  232.  
  233. Additional information to the output: 
  234. ======================================================================
  235. === What will VersCheck say, if it display special things like *-> ===
  236. ======================================================================
  237.  
  238. 1.) Printline "VersCheck" , field "Name"
  239.     VersCheck prints a name like 'hello.library   hello'
  240.     This isn't a special, this is best view you can get! If you see
  241.     this, the resident tag is filled 100% correct in both alpha num
  242.     fields. Because this is in must library's NOT so, I take first the
  243.     field NAME and then the field VERSION and cat both strings to one.
  244.     Only, if both strings are correct filled the result like above can
  245.     displayed.
  246.  
  247. 2.) Line "VersCheck" and line "c:version" show different versions. And
  248.     at the resultline (old,new,ok) is a * at the beginning before ->
  249.     This mean's 'CAUTION!', the $VER: and the resident tag have
  250.     differnt versions. A function in VersCheck try to analyse this and
  251.     give the best result, VersCheck can find. In simple form's: both
  252.     version older as the list: must be older. Both newer as list, must
  253.     be newer. And so on. The full function is complexer but VersCheck
  254.     can so printing a hopefully right result. To say you, it can be a
  255.     wrong result the * is set to this lines. Normally a * isn't a char
  256.     in a directory or filename (ok, you can create such files, but this
  257.     brings only trouble). If you take the AllXXXX file and search
  258.     inside for a * you find all critical entry's and not more or less.
  259.  
  260. 3.) The line "VersCheck" or the line "c:version" is not displayed.
  261.     The line VersCheck" is normally every time displayed, but both have
  262.     the same reason: The function to find $VER: (or in VersCheck the
  263.     additional resident tag) are failed and so the entry is empty. And
  264.     this empty entry isn't displayed.
  265.     If both lines not displayed, the file seem's to be corrupt or is
  266.     very bad coded.
  267.     Check such files with a program that can expand packed files. This
  268.     can also be a reason, but then is the auto entpacking not working!
  269.     The check take CheckX from Aminet or every newer anti virus program
  270.     you like. They all can decrypt. For SAVE the decrypt file, I know
  271.     only CheckX has this function at the moment.
  272.